std::forward_list::before_begin, std::forward_list::cbefore_begin

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++0x feature) Atomic operations library (C++0x feature) Thread support library (C++0x feature)
Containers library
array (C++0x feature) vector deque forward_list (C++0x feature) list set multiset map multimap unordered_set (C++0x feature) unordered_multiset (C++0x feature) unordered_map (C++0x feature) unordered_multimap (C++0x feature) stack queue priority_queue
std::forward_list
Member functions forward_list::forward_list forward_list::~forward_list forward_list::operator= forward_list::assign forward_list::get_allocator Element access forward_list::front Iterators forward_list::before_begin forward_list::cbefore_begin forward_list::begin forward_list::cbegin forward_list::end forward_list::cend Capacity forward_list::empty forward_list::max_size Modifiers forward_list::clear forward_list::insert_after forward_list::emplace_after forward_list::erase_after forward_list::push_front forward_list::emplace_front forward_list::pop_front forward_list::resize forward_list::swap Operations forward_list::merge forward_list::splice forward_list::remove forward_list::remove_if forward_list::reverse forward_list::unique forward_list::sort

​iterator before_begin();​		(C++0x feature)
​const_iterator before_begin() const;​		(C++0x feature)
​const_iterator cbefore_begin() const;​		(C++0x feature)

Returns an iterator to the element before the first element of the container. This element acts as a placeholder, attempting to access it results in undefined behavior. The only usage cases are in functions insert_after(), emplace_after(), erase_after()

Contents 1 Parameters 2 Return value 3 Complexity 4 See also

Parameters

(none)

Return value

iterator to the element before the first element

Complexity

constant

See also

begin cbegin	returns an iterator to the beginning (public member function)
end cend	returns an iterator to the end (public member function)